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This manual and the abject code Ccontained on florry disks is serial 
numbered and erotected by a levitimate copyrisaht. Ho rart of this 
marvel wes be copied ar rercraoduced without the exeress written 
rermission of the corurisht cuner. Carl Moser. You may make a 
beuthkue cores of the diskette in order te eroatect your copy of this 
software. It is though & Federal crime to make a cory af the 
maria l om flamers disk for use by arsone ather than the individual 
whio Purchased this software or the individual a comeany rurchased 


the softmare For, 


Thus. dou are in violation af Federal Coporisaht Laws if you da one 
fof othe Fol bowares 
~ Make & corsa of the manuel. 

~ If sou allow soneorne else to use sour corns Cor backurs? 
of the object media Cdiskette? while you retain a cored 
Or are US & cores, 

- Tf sou. sour caomearra, or others eurchase one or more 
caries and more individuals simultaneoausla use this 
software than the number eurchaced, 

- [Tf sou allow someone else to dao the comsins of this 
fiaterial. acu will be considered a2 2 party to the 
Lnteinsenerit. 


weed wi ll kee eecvdded fir argc who sure lies information which 
d= to the erosecutiaon of warties who violate this comyrisht. 


ith 


Aor 
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We do not presume that you are ar will violate comsrisht lames. Most 
Weers do mot. Some thoush do. snd mas moet realize the conseauences 
for wiclation of this Federal Lew. Fenalities and fines can he 
“uite severe for both individuals and comeanies whe infringe this 
copa lakit. 


fet ineortentls, software houses like the one which wreote this 
software have incurred & tremendous investment that can 

mot be fulls recovered if current illesal comyine comtinues. 
Also. urdates and program maintenance willl fave to ke terminated 
if the return on investment is mot sufficient. 


Finally: an express anereciation is siven ta the eurchaser af 
this software. He hore that scu find it a valuakble and 
worthwhile investment. 


If sou encounter ara erob lems. caormtact us at: 


Eastern House Software 
Carl Moser: 

3239 Linda Drive 
Minston-Salem. We. C. 2riee 
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1. INTRODUCTION 


This Macro Assembler *ASSM? and Text Editor “TED? resides simultaneous ls 
im 16K butes af memors CSGHG-PPFFO. The collective assembler and 

text editor if referred to as MAE. MAE was desisned to work with the 
Commodore 32k PET cnew FOMS> and the 2h4e@ Disk Irive. Versions 

also exist for 46 columm FETS retrofitted with 4.6 FOMe and for the 


CBM SB calumm FETs {Shs22, 


d 


1¢ 


As mentioned. the MAE cbject code accurmies 16K of menor. In addition 
ta this, sufficient memors must be allocated for the text 1 le 


and label #1 le Csumbo | tables. Areroximate la EK is su¢ficient 
memnors for the text file for small erosramns or larser prowrame if 


assembled fram disk. If an executable abject code file is to be 
stored in menars durin enki las sufficient memos must ke roa chec 
for that alsa. On cold etoentes (F50080, MAE will set the file 
houndaries as follows: 


a 


ri 
tear 


My 


e Text File = $26eh-F4FFC 
. Label File = $1 860-$2FFC 
. Relocatahle Object Buffer = $F anu 


These houndaries leave memorsa for the extended monitor (FLHGH-F1ITFF?. 
the DOS surereoart at urrer memnorg. and mencresa for Basic and Machine 


Lansuase prourams CFH409-$1 000", 


The label file and test file that MAE generates 12 eosition 
inderendent and may be located eracticalls arrswhere in RAM menor. 
The obgect code file location if derendent on the besinmins of 
assembls ¢.BA eseuda ont and the MC eeeudo cor, 


MAE was designed such that records in the label file and text f11e 
are Variable in lensth and directls derendent on the rumker ot 
characters toa be stored. This results in more efficient 

uti lization of memoars. 


Some uniaue features of MAE are: 

. Coexists with FET Basic. 

. Macro. Comditional Assembla, and Interactive Assemk ls. 

. Labels up to 31 characters in length. 

» Auto line numbering for ease of text entry. 

. Creates both executable code in memory and re locatah le 
object code on disk. 

. Manuscriet feature for commosina letters ard ather text. 

. Loading and Storing via Disk. 

. Suprorts Serial IQ andor IEEE erinter. 

. String search and rerlace carakilita., elus other msawerful 
editing commands. 


» Autc repeat af any key held down for 1-2 second. 
. Capability to send command strinas ta 2646 Disk. 


MAE uses a rrompeter character ¢]> 

to indicate that it is ready ta accert commands. Command mnemonics 
referenced in this dacument are rerinted with the rprameter 

Cexame le JER?. When inputting a command. you should not tyre 
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"]" preceedinas the mnemonic. 


Initial entry for cold start? to MARE is at address #5004. I the 
bread canmand CJBR> is executed. cone may reenter MAE at €5003. 
Initial entry eravides the followina default parameters: 


Format = set 
. Manuscrint = clear 
Auto line numberinsa = off 
Text file and Label file = clear 


MAE was designed toa coexist with PET Basic. This was accomp lished 
bea preservirs Basics zero rage variables. Thus, on cold start 
entry, MAE coeies all 256 butes of zero rave to a save ares 

CFT S6GH-F7OFF 2. On all exits Cwis JER. JEU. JUS, MAE restores 
these variables. On warm start entry, MAE swans zero pave with 
the save arex. MAE also uses 2 rumber of absolute variah les 

at $77oa-t7rFF 


Fenenker, MAE is a 18K sustem which uses memory from £3686-377FF. 
Wom should eroetect MAE from Basic bu settina the Basic variable 
HIMEM (esd, $350 to eoint to just below MAE and its text and 


lake l #1 les For exanele, to eratect memors above $2006, 
enter $68 at lacation #34 and #20 at location #35. 


This sottware has heen extensively tested and is believed ta be 
entirely reliable. It would be foolish to suarantee a erosaremn 
ef this size and come lexitsa ta be free ar errors. Therefore, 
We SESE pots responsibi lite for the failure of this software. 


aht. This material may not be copied, 
"jeval sustem, or otherwise 

due licated without the weitten cermission of the cauner, 

Carl Moser. The eurchacer mes however make cormies cf the 

diskette for his aun individual use for backur murreose. 

The wurchase of this softmare does not convey any license to 

manufacture, modify andor corms this eroaduct in any manner. 


MARE is erotected bua a Cory 
reproduced. stared in ar 


2. FILES CONTAIMED OH THE DISKETTE 


The sure lied diskette contains the fallowins f1 les: 


Fi lename Tescrirtiors 

MAE “DOS. EXE Enhanced [05 Surmeort Program Cdedse> 

EX TRANOH. EXE Enhancement ta FET M.L. Monitor 

EX TRAMOH. IHS and instructions - Courtesy Bill Sei ler-CEM 

MAE. EXE MAE object code 

RELOC. EXE Relocatins Loader object code 

RELOC. REL Relocating Loader relocatakh le code 

FET.LIB * Library af PET FROM locations 

MAE. WOT # Some motes on MAE 

HORDIP. EXE Hord Fracessor Program 

WORDP. IHS # Word Processor Instructions File and 
exane le of raw text 

MLMACROS.MLIB * File of some Machine Lansuase Macros 

SWEETIG6G.MLIEB * File of SWEETI6 Macros (Use with PET16: 


FAGE 2 


see #20 and #25 issues of Micro Masazine? 
IEEE.LIE * IEEE Machine Lansuscse Driver Routines 
SECTOR. CTL # Exanele erogran which illustrates use 
SECTOR. FGM of TEEE.LIE - dise lass disk sector 


URRT.CTL 

UART. Mei € EXAMPLE FROGRAM 
URRT. Mee CURRET Driver 
UART. Mes 


fource files in MAE format. 


It 
ou 


3. ENHANCED D035 SUPPORT PROGRAM 


The first file om the MAE diskette 12 named MAE-DOS. EXE. 

This file is an enhanced version of the DOS Surpmort perosray sure lied 
be Commodere Business Machines. The standard DOS sursort commaricds 
mee ded sue : 


T Lead and run Basic priser ai 
a Load Basic or Machine Larctiase Progr ain 


> Read disk error channel 
>Fr Dise lay directors for drive ri 
Toned Pass commend strins to disk drive 


In addition ta these commands, the MAE“DOS. ERE program erovides 
an alto-rereat key feature and the followine MAE Sueeort consis : 


AC Load MAE. ESE*® “MAE Assembler “Test Editor? arid bein 
execution at the oold start ertresy (#58842 

Ald Besin execution at the MAE warn start (fFTeG 2 

Mt Lead EXTRAMNOMESE# (Estended Monitor? amd besin 
execution at the cold start entry CFLlean: 


riled Besin execution at the Extraman warn start entra (Fusup3 
LC Load REL. EXE#® (Re locetina Loader? and beswin esecution 
at the cold start entrees (FH5H8> 


LI Ain execution of Relocating Loader ¢CFB5He% 


bo ¢ 


The purrase af these additional commands if to eroavide a sauick and 
camvenient means ta perform sane af the more common MAE functions 
but with minimal keystrokes. To illustrate this. compare the 
followins tuc methods of loadins and executing the MAE. EXE#¢ 
Prosran : 


13 Without MARE Suproart Conmmerids - 
“MAE. EXE* 
SY'5 2h4sa 


Mith MAE Support Commands : 


Po 


The difference is 26 keystrokes versus Just 3! 
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4. TEXT EDITOR ¢TED? FEATURES 


The TEL occuries acrereximste ly one-halt the total memara sreace 
af this software. The eurrase of the TED is to setur and 
Maintain the source file key interactina with the user via vaericquse 


Coline = 


Wher ineuttins to the TED. the user hae aval lable the full 
carebilities af the bullt in cursor-oriented screen editor 
me lus the additional feature of automatic rereat of arg kes 
hela dome fer 5 secre, 


When listins ta the CET or printer, the user has control of the 
outeut vis the Ffollomwirns lkeas: 


= TOF Tenmeorari ls halt quteuttings and amsit ineut of one of 


the fallowires kegs. 
TEL - Return to "J" lewel, 
MIF F - Continue erocessins but suppres= outeut exceet for 


errors. 


e - Certinwe outeuttins after STO, 


A. Cicenit eric = 


The TED erovides 2F command functions. Each command mroenonic must 
besin lnmediatela atter the erometer ¢]>. When entered, 2 

command te mob executed until =o carriase return is siver, 

Althoush = command mmenmania such as JPR mas be several non-seace 
characters in lenath. MAE onba comsiders the first two. For 

ean le, JPR. JFRI. JFEINTs and JFRETTY will be interereted as 

the erint commer. 


Sone conmands can be ertered with various raraneters, For exsume le. 
JFRIHT 18 286 will erint out the test in the text file with line 
numers between LA and 266. One must serarate the mremonic ana 
the wrarameters fram ane another be at least ane srace. 

Lo nok use commas. 

A dist filename may be seecified in some af the fallawins commands. 
dhepever “fil le" ls s1lyven a8 8 command earamneter. its format is 

a= follows: 


—_ 


mm ty 


Tr ede de cune " 
where: nm is the device number default = o: 
dreive is the disk drive number Ch ar 13 
nan 15 the file name 


Examen les are: VS 6" dt: MAE. NOT" 


Is "> RELOC. REL" 
"DOS SUPPORT" 


a 
kT 
im 
m™ 
@ 
on 


A descrirtian of each command follows: 


JALFHA 


Tosgsle shift character set fran grachics to lower case 
and vice versa by toywslins PET control at #E84C, 


JASSEMBLE file uw 


If file is sreecified. load the file into text tile arid 
then beswin assembly with comtents af test file. 


If w=LIsST then sernerate = listins. 
If weHOLIs7 or mw mot entered then an errors ormba cuteut 
will be sernerested. 


JAUTO x 


Resin aute line numberins mode with next user entered 
line mumber. * srecifies the increment to be added 
Lin 


to each line number. Tol) Wed &sit aute line rarmkeer ies 
by entering - immediately Ffollomines the eronmethed Lire riuanker. 


JBASIC 


on 


I 


Restore zero nase and wa to Basic. 


JEREAK: 


RPestcre zera page and ao to Monitar. 


JCLEAR 


Clear text #ile. 
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JCOFY 6 6x& 6 OZ 


Copy lines u thru z in the text file to just after line 
rumker x. The comied lines will all have line numbers 
equal ox. At comeletion. there will be two copies of 
this data - ane at = and the orisinal at yx. 


IDE “esenm arid" 


lek: commands ta PET 2446 Disk. Any commands that 
ntered with the FRIHT# Basic statement may 


f] 
entered 


Esse le: Outeut directory 1s we "se" 
Soratch file TEST is JIC "5S: TEST" 


Hete > Enteaoot JIC with no parameters results in disrelsy 
of errar disk error channel messages. 


JDELETE 4 

Delete entries in the text File between Line numbers 

~ and a. If anlys =» is entered. anly that line is deleted. 
JEDIT + Si t Se t CIF: JEDIT wr 


Steins search and ree lace, ar interline edit. 
See part 8 


JFORMAT wi on 


Format the text file Cwhere w=SET? or clear the format 
feature Cwhere w=CLEARY. Format set tabulates the 

text file when cuteutted. This lines ur the various 
source statement fields. 

re srecifies the rumber of characters rer label Cmax. = 31>. 
This is used to tabulate the listing. ° 
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JGET file yx 


Get file fram disk and store in the text buffer. 

If w is not entered. store at start of text butter, 
If wis a line number, enter followings srecified 
line number. If 4 = APPEMD then enter fol lomiries 
current coartents of text 1 1le. 


Examr les: JGET "MEMTEST" 
JGET "“1:CRTIVRE" 18 
JGET "BS URET" APPEND 


JHARI w x 


Format for hard cams listing. This feature is desisaned 
ta work with 66 line eases and leaves marain at toe 

and bottom salons with esa number. 

JHA SET turns this feature om. JHA CLEAR turns this 
feature aff. x is the startins esae number. 

JHA PAGE advances to tor of mext rane, 


Each time JHA SET if entered. MAE resets 
line counter to @ Thus. you must mer 
the paper in the printer so MAE and tk 
are synced. 


JLABELS w 


Print out the entire contents af the label file if 
W=ALL or mw not entered. Frint only fixed texternals 
labels if w=FIXED. Print only internal or prosram 
labels if w=FPROGREAS. 


JMANUSCRIFT w 


If w=SET, line numbers are not auteutted when executing 
the JPR command. If w=CLEAR; line rumbers are autrutted 
when the JPR command is executed. Assembly autrut 
ignores the JMA command. If manuscript is ta he 
generated using MAE. manuscriet should be set and format 
clear CJMA SET. JFO CLEAR>. Since the TED considers 

a blank line a deletion. you may insert a blank line 

bu entering a line with a sinsle periad. When erinted: 
a blank line will be autrut. 
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JMOVE x 3 Zz 
Move lines uw thru z in the text file to just after line 


number x. The moved lines will all have line numbers 
eaual ta x. The original lines v thru z are deleted. 


JNUMBER x 4 
Fenumber the text file startina at line x in the text 


file and exrandina bye constant yu. For example, to 
renunker the entire text file by 18, enter JNU @ 1, 


JOUTPUT #1 le 


object file om disk. This command 


Create = re locat: = 

uses the 256 kate relocatable buffer that can be 
reallocated via the ISET command. 

JFASS 1 1e 

Execute second eass of assembly. First pass must be 


previous la eerformed. If file is entered then the 
text file is loaded before executins the second rass, 
else JPASS will sssume the file is in the text file. 


JFRIHT ‘a 


Frint the text file data betueen line number x and y 
om the CRT. It only x is entered, only that line is 
ereinted. If na «x and vy. the entire file is erinted. 


JPUT file x 4 


Fut text file between lines x and y ta disk. 
If ~ and y are not entered, the entire text file will 
be wut to disk. 
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JRUN lake l 


Rum Cexecute>) a previcusly assembled program. If a 
sumboalic label is entered, the label file is searched 
for the startins address. The called rrogram should 
cemtain an ETS instruction as the last executable 
instruction. 


JSET te te ls le bs 


If no parameters are sivern. the text file. lakel file, 

and re locatak le butter boundaries Caddresses 

indicatina test file start. end. label file etart. end: 

and re loceatak le butte er starts will be outeut an the 

first line. On the second line the quteut canziste 

of the present end of data in the text and label file. This 
caonmeand is commonly used te determine how muck memces 

is remaining in the test file. If wou are inmeuttina 

hes digits for these addresses. preceed each with = 


“$°" character. 

If warameters are entered, the first tuo sre text f1 le 
start (te) and end ¢te? addresses, then the label #1 le 
start Clss ard end Cle addresses. and finally the 
relocatable buffer start address thes, 


Assign terminal ineut keyboards as FET 1# w=FET. ar 

serial device if w=SERIAL. Both ineut and cuteut will 

be ssesisned ta the serial device if w=TERMINAL. 

It entered. m is the number of pad bits to be sent an 
SnCu ace of carriaswe return. 


Mhenm JTI SERIAL cr JTI TERMIWAL if entered. ‘sou must 
ture Soon the serial keshboard so MAE can determine 
the baud rate of the device. Permissable baud rate 

A. a) 


l = 
u Se 


are 114, ae ehh. Loko. S468, 4508, Fees. and 36 
After you tyme S. weress the return feu. I+ MAE 
receiwes o Yelid carriage return character. cartral 


is then trans ferred ta the serial dewice. If a valid 
carriase return is mot received. contral will remain 
with the FET. 


WO ow nm ot 


Assisan terminal outeut CCRT ar printer? as: 
PET if w=FET, IEEE device #4 if w=IEEE. or serial 
if w=SERIAL. If w=ALL. then outeut will be directed 
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toa hoth the IEEE and the serial device. 


If w=SERIAL or ALL,» then n is the baud rate code and 
m is the number af ead bits om occurrance of carriage 
return. The baud rate code (n> is as follows: 


n haud rate 
a 1146 
1 e153) 
2 6ae 
3 1266 
4 =488 
a 4300 
6 reo 
r 3604 


JUSER: 


Restore zera page and sa to location #8000, You must 
have entered a IMF instruction at that address. 
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R. ENTRY/DELETION’CHANGE OF TEXT 


Source is entered in the text file by entering a line number 
€8-9999) follcawed bs the text to he entered. The line number: 
string can be ane to m disits in length. If the strings ic greater 
than 4 digits in leneth. only the risht-most 4 are considered. 
Text may be entered in ans order but will be inserted in the text 
file in numerical order. This wravides for assembling, erintine, 
and recording in mumerical order. Ars entrees consistina 

ef a line numker with ro test or gust sraces results 

in a deletion of any entry in the text file with the same 

rumber. If text is entered and = corresrondina line number 
already exists in the text file. the text with the corresrondinsa 
number is deleted and the entered text is inserted. 


To delete the entire file, use the JCL command. 


To delete a range af lines, use the JIE command. Toa edit an 
existing line ar lines having similar characteristics, use the 
JED conmand. 


To alter an existing line. use the JED command form 2. 


Toa find & strings. use the JFI command. To move ar cary lines 
use the JMO aor ICO commends. 


To insert a blank line, enter a line with just a reriad ¢.9. 


Text may be entered more easily ba use of the aute line 
rmunmberins feature CJAL command’. Any JAU x where = does not 
exuual & wuts the TED in the auto line runmker made om the next 
entry of a line munber. Ta exit form this mode. tare J’ 


When entering source for the assembler. ome need not srace over 
to line ue the various fields. Labels are entered immediate ly 
atter the line number. Serarate each source field with ane or 
nore spaces. If the format feature if set Csee JFO command:, 
the TED will automatically line ur the fields. Note: If 
seace is entered before the label. the TED will line ur the 
label in the next field. This should result in an assembler 
errar when azsembled. Commands. mnemonics, and eseudo ars mes 
be entered as uncer case or lower case characters. Labels in 
the erowraa may be entered as urrer ar lower case characters 
but = label entered as urrer case will be uniaue ta the same 
label entered as lower case. 


3. ASSEMBLER “ASSM> FEATURES 


The ASSM SCANS the source program in the text file. This reauires 
at least 2 passes (or scans?. On the first pass, the ASSN 
wenerates & label file Cor symbol table? and outputs any errors 
that mas occur. On the secand rass, the ASSM creates an 

oeticnal listins. 


A third rass Cyvia JOLI>, may he performed im arder ta senerate a 
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relocatable object file of the program in the text file. This 
file is recorded on disk and mas he relocated at the users 
descretian practically anywhere in memory. 


RA. Scaurce Statement Suntax 
Each source statement consists of 5 fields as described below: 


Jline number lake 1 mnemonic orerand comment 


The first character of a label may be formed from 
the fallowiny characters: 
@ Athru?g? C SN J t € 


While the remainins characters which form the label 
may be canstructed from the above characters and the 
folloawins characters: 

» oo 8 thru 9 © 3; € > F 


The label is always entered immediately after the line 
riLatiekeer e 


Mremonmic for Pseudo Csi: 
The wmrnemnanic or eseudo am is separated from the label 
be ote ar more sraces and consists of a standard 


6242 mnemonic af table A. eseudo op of table B, or macro name. 


Cipcomee sorecd : 
The operand is serarated fram the mnemonic or pseudo ar 
bea one or mare sraces and may cansist of a label 


expression fran takle C and symbols which indicate 
the desired addrezsins mode from table D. 


Cetumneerrt : 
The comment is serarated from the operand field by one 
or more sraces and is free format. A comment field 
hexine one ar more sraces past the mnemonic or rseudo apr 
if the nature of such does not reauire an crerand field. 
A free format comment field maa ke entered if a 
semicolon ¢39 immediately follows the line number. 


HOTE: It 15 wermissable to have a line with only a label. 
This if commonly done ta assian two or more labels to 
the same address. If the line has only a label or 
label with comment, then the label may be any length 
ur to 79 characters reyardless of the label length 
set with the JFORMAT command. 


ADC 
AND 
ASL 
BCL 
BCS 
BEt! 
BIT 
BHI 
BNE 
BFL 
BRK 
EB \! C 
BY'S 
CLe 
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TABLE A - 6562 Mnemonics 


For a description af each mnemonic, consult the 6562 


Software Manus ls 


cLo 
CLI 
IMF 
CP 
Cry 
TEC 
TEX 
DIE's' 
ECir 
THIT 
THs 
THs! 
JTF 
JSF 


LDA 
LI 
LI’ 
L'SF: 
LY 
CFA 
F'HA 
FHF 
FLA 
FLF 
FOL 
FOF: 
FTI 
RTS 
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TABLE B - Pseudo Ors 


~BA label expr. 


embly at the address calculated from the label 


Kesin 25 

exeress1 crt This address must be defined on the first 
ress or am errar will result and the assembly will halt. 
BY 


utes of dats. Each hex, decimals or binary kbyte 
5 t ane space. An sscll strings 
ning and endina with arcstrorphes 
‘(DY 47 69 “2° FC 21161 


wCE 
Comtinue assembly if errors ether than !@?. !B4, and 117 
\ccur., All error messaves will be erirted. 


CT 

Designate current contents of text buffer as a control 

file. tin Le one control file masa exist during each 

assembly. Tesisnation a= a cantral file allows the 

wee of FI eseudo ops to link other files for the 

assem ba peroness. 

Hote: Crile one EH eseudo an 1s allowed in each 
ascembly and if .CT is used. the .EN must be 
at the end af that file. Thus. #1 les referenced 
Wis .FI must rot have = .EN pseudea ar. 


label TIE label expr. 


Hesican the address calculated from the label exeression 
to the lakel. Designate as external and eut in the 
label file. An error will result if the label is 
omitted. 
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label ..DI label exr. 


Resian the address ca lou lated from the label exrression 
ta the label. lezianate as internal and eut in the 
label file. An err l sult if the label is 
omitted, 


tt aa 
Mo 


Define = block of storase. For exanmele, if label exr. 

exuated ta 4. then ASS will skin aver 4 butes, 

Mete: The imitial contents af the block of steorase 
1= undefined. 


EC 


Sueeress quteut af macrae wenerated okbjeckh cade am scuece 
listins. This is the default state. See wart FE. 


EJ 


Eject ta tar of mest pease if JHA SET was rerevioue ls 
entered, 


~EN | 


Indicates the end of the source rerowreu., 


~ES 


Quteput macro generated ekbject cade en saurce listings. 
See part FE. 


~FI file 
Assemble the specified file before continuing with 
statement following FI. 


Hote: The .FI eseudo ar is allowed anly in the cantral 
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file Cthat designated with .CT>. 


~IH label 


Chiteut ? Followed with space and ther accert exactly 
4 hex digits. These hex digits will be sssisgned 
ta label and stored in the label file. 


Ineut witl only accur an the first ewass of assembly. 
The lake l must be symbolic and should ke defined 
Similar ta the followins exanie le: 


REGIH. ALLE: 
.PRO "EMTER ASSEMELY START" 
~IH BEGIH. ADDF: 


Ore should avoid usins DE. DI, SET to define 


or 
the label as these constructs reassian their 
seecified value an each pacs. 


~LE 


Clear the list optian so that the assembly terminates 
merintina the source Llistina after the .LC on pass 2. 


LS 


Set the list cetion so that the assemb la besvins serinting 
out the source listins after the .LS an sass 2. 


AC} =6label exer, 


When storins object code, move code ta the address 
caleulated fram the label exeressican but assemble in 
relation to that srecified ka the .BA eseudo ar. 

An undefined address results in an immediate 
sssembla halt. 


M0 


Maceo definition. See part SE. 
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ME 


Macrae end af definition. See part SE. 


MG 


MG declares the entire contents of the text file as 
Maceo Global. When assembling from disk.» all 
followins files will be loaded into the text #ile ar 
followings the file with the .MG. Thus. even thea 
there can ke mana modules loaded and assembled, the 
race Slobel file is “lacked” into the text 
erovidins its mace definitions for use 
subsequent #1 les. 


it 
ny 


#i 
4aall 


le ares 


= 
e 
= 
br 


Clear the abject store o-tion so that object code efte 
UC if not stored in memory. This if the default aeti 


Set the cbgect store artiaon sa that abject cade after 
the .05 1s stored int memors orm eases os. 


PRO hex" 


Duteut the text that is enclosed in sauctes when the 
FPR is ercountered. MAE autcamatically issues = 
carriage return immediately before cauteuttina th 


e text. 
The text will be outeut onla during the first rass 


af the assembly. 


RC 


Provide directive ta the relocatins loader ta star 
resolving address information in the ckhoect code 
rer relocation reauirements and store code at the 
ere-re located address. This candition remains 1 
effect until a .FS pseudo op is encountered. 
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RS 

Praevide directive to the relocating loader to resolve 
address information in the object code per relocation, 
and stare the cade at the rrorer relocated address. 
This is the default condition. 


wrE 8 label exer. 


Store the address calculated from the lahel expression 
in the next two memory locations. Consider this address 
as beins an external address. Note: If & lahel is 
sesianed ta the .5E. it will be considered as internal. 


Store the address calculated fram the label exreressian 
in the nest tuo memory locations. Consider this address 
ae bein an internal address. 
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TABLE © —- Label Exxrressione 


A label expression must not conmszist of embedded sraces and is 
constructed from the fol lowiris: 


Symbolic Lake ls: 
One te 31 characters comsisting of the aseii characters 
as previously defined. The macxcimum rmumber of characters is 
set bu the JFORMAT SET mo command where rmo= the meccimum 
riamier allowed. The default maxinum is 18 characters per 


Hom Sambo lic Lake le: 
Tlecimals kes. or binges values may be entered, Forno 
Sreclal sambol ereceeds the numerals then the ASSAM sssumes 
decimal Cescmele: L4eo. If € ereceeds. then hes i 


LE meet 


Sune seme le: EPRo. If ® pereceeds, then birers 1 
Shined Censnme le: ALLGH13. Leadine zerce need moh be 
iterped., If the decimal oor hex strins is sreater than 
digits, omls the rishtmost 4 are considered, 

If the binary strings 1s sreater than &. anla the 


riakrtmost 2 are considered. 


Tht vt 
| 


Se tT 


Precearcun Courter: 
To indicate the current location of the erogreanm courter: 
Wee the sambol =. 


t 


ot 


shove label exeressian 


hye = = 


re Pecor ted: 


c J 
se are used to serar = 
penits. | Tuc cer ecto 
addition 
subtraction 


it tb 


te 


Exame les of some valid label exrresesioms fo] Low: 
LIAR #81161 iLOAD IMMEDIATE #60 
STH #€TEMF+#a1 SSTORE AT BYTE FOLLOWING TENF 
LOA #4F1636 sLORD FROM LOCATION $1656 
JIMF Lade+ct-$46] SINE To CALCULATED ADDRESS 
BHE =+5 JBRAHCH TO CURRENT FO PLUS o BYTES 


One seecial label exeressian is A. a= in ASL A. The letter A 

Ffallowed with = sreace in the orerand field indicates 

accumu lator addressing mode. Thus LIA A is an error comditian 
Since this addressins mode is mot valid for the LOA mnemonic. 


Ath does mot result in accumulatar addressina but instead 
Pences & memary location. 
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TABLE JU - Addressina Mode Formats 


Immecdi ate : 
LIA 
LOA 
LIA 
LIA 
LIIA 
LIA 


#1181 


Abs lute : 
LIA 


Sera Pose: 


LIA #label exp. 


Abs lute iridesceed: 
LIA lake 1 
LOR label 


LIA 
LIIA 


ue 


# lat 
Eafe 


#1 
Indexed Indirect: 
LIA « Lake 1 


Tridarect Trideecceed : 
LUA ¢ label 


Indirect: 
JME 8 Lakve 1 
Acocuatied Lactic : 
AS A 


~ 


Tree La eed: 
TH 
CLE 


Fe lative: 
BEI: 


an 


2 Fase Tricdeeced: 
1 


mu 


a 


Tu 


5 
4 Aa . 


lake 1 eer. 


xe. HI FRET OF THE ADDRESS OF THE 
ae. LO PART OF THE ADDRESS OF THE LABEL 


w— in 
oat 
e «6 


» BINARY 

s HEX 

SYMBOLIC 

»ASCII 

LABEL 


iTHE ASTERISK #2 INDICATES ZERO PAGE 


sLETTER A FOLLOWED WITH A SPACE INDICATES 
ACCUMULATOR ADDRESSING MOTE 


/OPERAHD FIELD IGHORED 
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B. Label File Cor Sumbol Table? 


A label file is constructed by the assembler and may be cutrutted 
at the end of assembly Cif a .LC pseudo cop was not encountered 
arm wia the JLA command. The outeut consists of the symbolic 
label and its hex address. ‘Via the JLA commands, the user mas 
select which tyre of labels to ke outeut. ILA FIXED outruts 
all erosram and internal labels. and JLA ALL cuteuts 211 labels. 
MWhen a relocatable object file is senerated (via JOU command?» 
an’ instructian which referenced an internal lakel o- 2 label 
expressian which canzisted af at lesst ane internal label will 
ke taysved with special information within the re locatab le 
abject file. The relocatinas loader uses this information to 
determine if an address needs to be resalved when the peroaram 
is moved ta another reart of memora,. 


Corwerse lo. instructions which peferenced om external label 
or & label expression consisting of all external references 
will root be altered bet the relocating loader. 


At the end of the label file the number of errors whic 
cocurred ard ermosram break: in the assem la will be outeutted 
in the fallowins formect: AMEE so edd 2EFZ 


Where soe ls the number of errors found in decimal 


reeresentation, wuss is last address im relation to .FBA:, 
and 2zz7 is last address in releatian to JMC. 


Ct. Assemk line 


Saurce for a large proagran may be divided into modules, 
entered inta the text file ane at 3 time and recorded CJFU2 an 
disk. 


These modules can be linked tosether during assembla via a 

control file. If used. the control file must be the first 1 le 

to be assembled. This #ile must be in the text buffer when the 
JAS command is issued, or its name must be ified im the JAS 
command Cexamele: JAS "MEM. TEST". Files : Linke qd tovether 

Via the .FI eseudo on. For examele, toa ass le 3 files named 
BMA, SwMeS. and 2.MB3. we need ta senerate a control file ssa 
M.CTL Cnote for convenience we use the convention of tagging CTL 
an the end of ara name which references & corntral file while its 
modules are tagzed Mexd. The file M.CTL may contain the followins: 


i" 


ee 
re 
mk 


7 


CT 
FI DS "x. Med" 
.FI ODS "Y.Mae" 
TFT DS "2. Mea" 
EN 


How, when the control file is assembled. MRE is tald to sco assemble 
the files in the oarder srecified. 


po 
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At assembly. the assemkler can load and assemkle each module until 
the entire rrogran has been assembled. This will rewire twa pass 
for a commlete assembly. Hhen the end of a rass is encountered, MAE 
Will outeut the message END MAE FASS!. If for some reason you 
terminate the assemkla an the second Pass» wou may restart at the 
beximnins of the second rass using the JPASS command. 


TD. Creating a relocatskhle object file ¢]OLY 


In order tao create a relocatable okbject file. the programmer should 

identifa those labels whose addresses are fixed and should not be 

altered kes the relocating loader. This is done via the .DE 

meee cet Horm-sunbeo lic labels Cexamele: #8169) are also 

considered 25 bed ries external Care fixed? All other labels 

Cincludins those defined visa the DI eseuda ap) are considered as 
es SS S000 riated with internal labels can be altered 


lrternal. Ard dress 
bean oF feet wher “orem is loaded via the relocating loader. 
Alsa. the .SE =steres = tun bate external address and the .SI 
stores = two keate int er nal address. Similarily the relocating 
loader will alter the internal address and not the external 


address, 


An exenele af an external address would be the calls to FET ROM 
routines ar and location whose address remains the same no matter 
where the eroaram is located. Exrressians consistina of internal 
and esterrneal lake Is Will ke comkined and considered an internal 


address. A label exepressican consisting entirely of external labels 
Wa LL kee cocukr ad peed arid considered as external. 
The relocatinas loader can relocate your eragram in 3 segments: 


Sera wade waeriables Cinternal addresses in ranve $00-SFF), aksa lute 
Wepishles Cinternal addresses in range S6460-$1FFF2. and prasram 
bods Creferences in range $2000-$FFFF2. To senerate a relocatahle 
object File, first eartition your erodran into internal and 
external references. Remembers external references are these 
locations that are fixed while internal references are those 


locations which can ke altered kea the relocating loader. 


Start stsisgnins zero pase references at location FHHHu, abso lute 
Werlable locations at #6400. and besin assembly of the program at 
FSHHH. Hest szsenble the er roar arn W1la JAS. and then issue the 
JOUT conmeid to senerate 2 relocatable abject ile. 


Hom, we have the relocatable object code on disk. Toa load this 
object code back into memnors, first load the relocating loader. 
The relocating loader is contained on the diskette with the name 
RELOCESE. Execution besins at £568 if in the monitor or SYS 1286 
lf in Basic. The relecatinsa loader will reauest the followins: 


17 FILEWAME? Hame af the file containing the relocatable abject 


Sr code. 
2: Z2-FG OFFSET? Address ta besain assigmment of zera rave internal 
aenneineteniennentenieientinl references, 


3) ABS OFFSET? Address to begin assignment of absalute internal 
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wana anna references. 


4) PGM EXE OFFSET? Address the program is to execute, 


S> PGM STORE OFFSET? Address to store the program object code. 


When the file has been relocated ifs memors, it can be caved on dick 
Cusine Extramoans as an executable file, which mag be reloaded without 
using the relocating loader. 


As an exanrle, lets assume we wart to re locat hie 
UART to execute at location #3060. but store the objec 

$1608. and start the zero wage var isbles “at FaGE0, “ond ‘the, Shes lute 
Yeriables at £4600. We would reseond te the relocating loader as 
follows: 


FILEHANES Ds "1: URET. REL" © File name 
Z-FPG OFFSET: #658 * AHeslen start of zero nase var. 
ABS OFFSET? #4608 * Hesien start of abeclute war, 
PGM EXE OFFSET? #3808 © Frowgram bods start 
FGM STORE OFFSETS #168 © Store af code start 
LOAD MAP 
€ RL. cuteuts a load mar 
FILENAME? © Enter guest return to exit the 


a haateatentae ete Relocating Losder 


PAGE 24 


E. Macros 


MAE provides a macra capability. A macro is essentially a 
facility in which ene line of source code can rerresent a function 
canesistins of many instruction sequences. For example, the 65B2 
Lnetructior set does not have an instruction toa increment a double 
beste memory location. A macro could be written to rerform this 
operation sare peeresented as IHCD «VALUE. Ls. This macro would 
aeeesear in wour assem la lanswuase Llistina in the mnemonic field 
Similar to the foal lowe: 

BHE  SEIF 

HIP 


INCI iVWALUE. 13 SIHCRENEMT DOWELE 
LIA TEMP 


Before 8 macro can ke used. it must be defined in order for ASSH 
to process it. A macro is defined via the .MD tmacere definiticarn? 
meet ce, Ite form 1= 


Pit Lake 1 AAD cli Le ... bra 


Where label is the name af the macro cll lo must preceed the label:, 

arod Li. Le. ..e.s LA are duns variables used for replacement with 

the esransion variskhles. These weriskhles should be separated using 
Seayces, do pok wee connas. 


To terminate the definition of a macro. use the .ME “macro end 
pee gedice capt 


For exit le., the definition of the IHC Cincrement doukle bute? 
macro Colle kee see fee 1 Lous: 


PEITHET AD SLi STHCREMEMT DNOUBLE 
THE Lon 
BHE SKIP 
IMHO = La+) 

Sh IF ME 


ible definition for INCI. The assembler will not 


This is = 
ct code until there is a call for expansion. 


—) 
merida sbi 


1= 


. oe 


Hote: A call for exeansion occurs when wou enter the macra 
nan salons with its rarameters in the mnemonic field as 
IMCD «TEMPS or IHC ¢COLNT > ar INCI <COUNT+22 
or arn't other labels or exrressions you may choose. 

Hote: In the exeansion of IHCD. code is not beina senerated 
which increments the variable LOC but instead code for the 
assotlated varishle in the call for expansion. 


If sou tried to exwand IHC as described akboave more than unce, 
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you will set a !86 error messave. This ifs a duplicate label 
error and it would result because of the label SKIF occurring 
in the first expansion and again in the secand expancscican. 


There is away to get arround this and it has to do with makina 
the label SKIF arrear uniaue with each expansion. This is 
accompe lished bs rewritina the IMCD macra as follows: 


tItINCD JMO <Lor> SIMCREMEMT DOUELE 
IHC LOC. 
BHE ...5K1F 
INC = LOC+1 

oe SEIF JME 


— 
-! 


e only difference 15 ...5EIP is substituted for SEIP. What the 
SM does is to ssslign each macro exranslar & urnlaue metro 

QUeENGeE Mums CSRELE mscclinum macros in each Filles. If the 

@#l besins with ... then ASSM will assisn the macro sequence 
nher to the lakel. Thus. Since each exeansian af this macrs 

Ba unite Sequence rumkers the lake le will be uniaue arid 

16 err ow LL reek cencur. 


cy 


wm of 


a 
= 5 


> eS ee | 
it f 
+ hem 
i 


ri 


If the label ...5KIF also occurred in another macro definition, 
no 'H6 error will occur in its exreansicon if thes are not nested, 
If sou nest macros (1.6. one macro exeands another’. sou mors 

wet = 186 error if each definition uses the ...5KIF label. 

The resson this may occur is that a= ane macro expands another 
in a nest. they each set senuentialla aszeisaned macro sequence 
rumbers. As the macros work out of the nest. the macro sequence 
numbers are decremented until the torn of the nest. Then as futher 
Macross are exranded, the seauence rumbers are assin incremented. 
The end result is that it is wossible for 3 nested macra to 

hawe the same seauence nunber ss ane mot nested ar ame at a 
different level in another nest. Therefore, if vou nest macros, 
it is suss#ested that you use different labels in esch macra 
definition. 


+ in a 


Some futher motes on macros are: 
12 The macrea definition must accur before the exransioan, 


2) The macro definition must accur in each file that 
references it. Each file is assigned a unliaue fi le 
sewence number (2##16 maximum filles in each assemble: 
which is assigned to each macro name. Thus the same 
NAaCrO Can arrear in mare than one file without 
causing a !46 error. If a macera with the same name 
is defined twice in the same file, then the !86& error 
mill cuscur. 


Ol 


Macros mas ke nested up to Se levels. This 15 a © 
limitation because there is anly soa much menors lett 
for use in the stack. 


4> If & macre has more than one ranameter, the parameters 
should be separated usina spaces - da not use commas. 


So The number of dumivs earameters in the macra definition 
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fs 
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must metoh exactly the number of parameters in the call 
for exransilorn. 


The dunia warcmeters in the macro definition must be 
sumbe lic lakels. The parameters in the exransion mau 


4 sumko lic oor morm-s'amke lic label expressions. 


Ty 


ro! J¢ the .E5 eseuda am is entered, object code we 
bt the macro exeansilom will be outeut in the soured 
listina. Also. comment lines within the merc 
definition will be cuteut as blank Lines durin 
exraneian. Cornverse ba, rf .EC wes errtered. onmla the 
line which contained the macro call will ke cuteut 
im the source listing. 


oo Sane a2 2 BDL mnemonic. 
r 


A macrec rane med mok be the 
Pseudo om. or comditional se: 


Meret . 


FF. Comditiconal Assemble 


MRE alsa provides a conditional stsembla faciliteu ta conditionalls 
direct the assembler to sesemb 1 rtain eortions of wcur 

eros and cok ether reoartions. For exssmele., assume wou have 
written = CRT canteoller erodes which car erowide |i ther 

& 48, 64. or character eer line dise las. Inetead of havin 

to keer 3 different copies of the erograms, wou could use the 

ASS comditional sazsemkbla feature toa assemble oode concerned 

with one of the character densities. 


nd 


tT 


= 
—* 


it i iT 4 


Before we continue with this exemele. lets describe the 
Conditional Assembla oeerators: 


IFE lake l exe. 


If the label exreressian eaustes to a zero auantita., then 
sesenble to end af control block. 


IFH label expr, 


If the label exeression eauates to a auantityu not eaual 
to zero, then assemble to end of cormteol block, 


IFP label expr. 


If the label expression ewiates to a rositive auantity 
or 4600, then assemble ta end af contral block. 


IFM 


If the label ex 
then 


aUanitity, 


Be 


Three asterisks in the mnemonic 
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label exr. 


Eressian esuates to a neyative Cmirus? 
assembly to end af contral block 
field indicates the end 


ef the comtroal b lect, 


SET 


Set the erevious ly defined label ta the 
calculated fram the label exereszicon, 


NOTE : 


Goins bach 
CHAR. LIE . DE 
IFE 
sCODE FOLLOWS 


reer 
IFE 


sCODE FOLLOWS FOr 


rarer 
IFE 


sCODE FOLLOWS FOR 


+4 


All lakel 
Precision 


toa the CRT 
arrangement of the erosaram 1s ss 


FOR: 


lake l= lake l exer. 


uw iu 


“EP ess 1 
rithmet i 
conmtro ller 
40 

CHAR. LINHE-44 
4@ CHARACTER FER LIE 


CHAR. LIMNE-64 
64 CHARACTER PER LIHE 


CHAR. LINE-S& 
Sa CHARACTER FER LINE 


sCOMMON CODE FOR ALL 


eottware 
a= follows: 


aaritits 


ons are equated usins 16 - bit 
ic 


exame les = possible 


FAGE 


T' 
isi) 


Show is the arransement which would sssemble code azsaciated 
with 48 characters per line since CHAR.LINE is defined as 
exual 46. If wou wanted ta assemble for SH characters, 
Sime la define CHAR.LIHE se eaual So. 


Cearnditional assembly can alsa be incorporated within macra 
definitions. A vers power fu T MWSe 1S within & macro you 
dant wank came lete la exranded each time it is referenced, 
Fiore exauie le. S25ume acu wreote & macro ta da a sort an some 
date. It could be defined ss fol lows: 
EM PAMD UE & 
P6isokT JMO 

IF ESFAMD! 

JSF SORT. CALL JCALL SORT 

+04 


IFE EwFRAHD 
JSR SURT. CALL 
JHP  ...ABC 


ASORT CODE FOLLOWS 
SORT. CALL 


RTS 


WHEL SET EXPAHD=1 
sd 


WME 


In this exanme le. EXPAMDT 1s initialla set to @. When the macro 

lf @#xranded for the first time. EXPAHD exsuals & and the code 

at SORTSCALL will be sssemkled alonsa with = JSF toa and a JMF 
around the sark subroutine. Alsa, the first exransloarn sets 
EXPAHD to 1. On each suceedina exransion. anly a ISE instruction 
Will ke atsemk led since EXPAHD esuals 1. ls rina comditicanal 
aszemblaoin this examele resulted in more efficient memars 
Utilization cuver an eauiva lent Maceo Bxeansilar without 
morditional assemk la. 
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G. Interactive Hssembly 


Interactive assembly if & new concert in which the sesenmb ler 
HIG 


can be instructed ta print 
inmeut during the first es 


Seasve= andor saccert keyboard 


ass af the ascse vibe Ve, 


Interactive assembly makes use of tuo eseuda cps: 


PRE toa erint messases 
eIH to acceet beabosrd rrieiut 
An examele of the use of interactive sssembly is a5 follows: 
~FRE "INPUT START OF ASSEMBLY" 
ADI: 
~IH ADDF 
-BA ALLE 
Note that in this exanele, the assembler will reauest entra of 
an address to be azslismed to ADLIR. and then bexins szsemk ls 


at that address. 


There are mers are lications for interactive sssen 
those possibilities are left for the users oF MAE. 


NOTE: Never sreecifu 4a label as the crperand in the . IH 
eseuda cor that has heer defined bu the DE, DI. 
ar SET eseuda ops The ressorm 1s that these 
PSeuda cps initialize the address ssslered to 
associated labels an both aszsemkbla easses whi le 
all other labels are initialized anmlye an the first 
rees., Since the .TH eseuda om aocerts ireeut on 


the first wrasse only. ussse of labels defined by 
DE. .DI. and SET will csu different lake 1 
Values cn rats 1] versus mass 


1 in 
Wy Te 
o 


t a 


H. Default Parameters an entry toa ADSM 
Does not store abject code in memory Cotherwise use 05> 
Resins assembly at $4400 Cothermwise use . BA? 
Halts assembly on errors Cotherwise use .CE2 - 
AM unless & .ER or JAMIL 


Stores object code bexsinninsa at FH4E 
t 


is encountered and if .05 ifs rresent 
Ubsect code senerate a be macros does mot aeresr an the 
gzsembla listinsa 1. default is .EC? 


6. RELOCATING THE RELOCATING LUADER 


A relocatable abject file af the relocating loader if contained 
on the diskette with the mame RELOC.REL. 


FAGE 3 


To relocate the relocatins loader, load the executshle cory 
CRELOC.EXE> and kesin execution. When FILE NAME? is output, 
enter "RELOC. REL". Then enter @ for 2-PG OFFSET? and © for 
ABS OFFSET?. Finally. enter the address of the location 
wou want the relocating loader ta execute and reside for 
FGM EXE OFFSETY. and FGM STORE OFFSET’. 


When the reloacater come letes its task, wou may save an 
executable cams on disk usins the FET monitor. Just 

renenkber. execution kesins at the address seecified for the 
FGM EXE OFFSET - not $8500 as for the executehle corny suce lied 
CRELOC.ESE?. 
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vy. ERROR CODES 


An error messase of the form 's~x AT LIME yoy where xx is th 
errar code and uyyy is the line number will be outeutted if 
errar occurs. Sometimes an error metsaae will outeut an 
invalid line mumber. This occurs when the error is on s. 
non-existant line such a= an illesal command irwut. 


& 
ar 


The folloawins is a list of error cadets not sreecifticalls related 
to macras: 


ERROR CODE DESCRIPTIOM 


1k -EN in non .CT file when CT file exists. 
1A EM missins in .CT desisnated file. 

13 Found .FIo in rom .CT #1 le. 

18 

iv Checksum error oon disk load. 

16 

15 Syumtes error oan JED conmmericd. 

i4 Tevice munmbers Beds f.3 rot allomed. 

13 Multiscle .CT assisnmernt. 

= Commend ssrites error oar cutoff panse error. 
11 Missing warameter ins JHU conmmericd. 

iu Over+Flow in line # renumberins. 


CALITIOWN: you skeu led serceseer ba rerumker the 
the text F112 for pracer command coeratior. 


GF Qverflaw in test file - line not inserted. 
BE Overflow im label file - label mot inserted. 
Il MAE exeected hex characters. fourd rime. 

HC Illegal character in lakel. 

UB Unine lemented addressina mode. 

BA Err ary cee rice cece suid. 


Wo Found illesal character in decimal strains. 
Undefined label Cmas be 1llewal labels. 
2AM eseudo ce missiris. 

Tue licate label. 

Label missinas in .DE or .0T eseude om, 
-BA or JMC operand undefined. 

Tllesal eseudo com. 

Illegal mnemonic or undefined macro. 
Branch cut af rarce. 

Not & zera rade address, 

Error an commecid ireeut. 


ar 
mJ OC 


Lin 
nn 


Neawagac 
Ge PO DC 


The following is a list of error codes that are srecificalls 
related to macros and conmditian assembly: 


ERROR CODE DESCRIPTIUN 


ZF Overflow im file seauence count CfS##16G max.> 
ZE Overflow in number of macras C2e#16 max. 
=) 
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2k ME without associated .MD 

ZA Naon-s'symbo lic lakel in SET eseudo or. 

29 ITllesal nested definition. 

25 

ZF Macre definition overlars file boundary. 

=6 Tuelicate macra definition. 

Zo Guantity porns mismatch or illegal characters. 

24 Toc many nested macros C32 max. 3 

23 Macro definition not comm lete at .EN 

Ze Conditional sureress set at .EN 

zl Macro in exrand state at .EH 

=u Atteneted exreansican before definiticr. 
So. STRING SEARCH AND REPLACE COMMANDS 


A. Edit Command 


mauerful string search and replace, and line edit carahi lity 


A 
i= provided wig the JEDIT command to easily make changes in the 
text file. Use form 1 to strins search and rer lace, and form 2 
to edit a ewarticular line. 
Fosrct 1 
JEDIT thitset kd »& ‘4 
# 
Mere: + l= 2 NoMncMUMerics non-srace terminator 
51 as the string ta search for 
S2 ais the string to replace 51 
cd is den’t care character. Freceed with # 


character ta change the don’t care, else 
don’t care charscter will be % ku default. 

+ indicates ta interact with user vig 
Ssubcommands kefore rep lacina 51 

# indicates tc alter but erovide ma printout 
Note: No # or # indicates to alter and 

erowide erintout. 
x line number start in text 1 le 
‘J line number end in text #1 le 


Heterisk (#2 prometer scubcanmands : 
A alter field accordins ly 
I delete entire line 
a move toa next field - don’t alter current 
5 ekip line - don*t alter 
4 exit JED command 
2 enter form 2 
Lefau lts: d = & 
x = & 
“uy = 49999 
If no # or # entered then erint all 
lines altered. 


For exame le, to rewlace all occurances of the label LOOP with 
the label STREET between lines 160 and 660, enter: 


JEDIT “LOOPASTART.§“ 16m 6H 

To simply delete all occurances of LOOP, enter: 
JEDIT “LOOF,.” 166 6h 

You may use the # and # as described above, 


The slash ¢""S wat used in the abowe examples as the terminator 
but any non-numeric character maa ke used, 


At the end af the JEDIT ormeration.s the riumber of occurances ot 
the strings will ke outeut as o veMnexs where wexe le = decima] 
ausnitity. 


Form 2 


JEDIT wn 


Where: nis the line rumber (8-99995 of the line te 


ke edited. 
After executing the commands cursor over to the mart to ke 
changed. and either tare over ar use the THSDEL key on the 


FET just ae wou would use the screen editor. Frese RETURH 
when dome, and MAE will insert it in the test #1 le. 


BE. Find Commaried 


If you want ta gust Find certain occurances of a marticular 
strings, use the JFIHD command. Its form 15: 


JFIHD +t5it # x 4» 


1. # «. and ware as defined in EDIT command. 


oo 


Where: tt, 


at] + 


iT 
ur) 


Fer examele, JFINO “LOR will auteut all accurances 
the strina LIA in the text file. 


At the end of the JFIHD areratian. the number af occurances 
of the strings will be cuteut as “exexx where x=ex 1S 2 
decimal auantity. 


A uniaue use of this command is te count the number of 
characters in the text file Cexcludina line numbers?. 
form for this is: JFIND -#-# 


The 
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9. CONTROL COTES ‘(Serial Device> 
The followings aeelies ta the cretional serial device connected ta the 
FET. Ascii characters whase hex Values are between hex G6 and 26 are 
normally noncerintings characters Mith a few exceptions, these 
characters will be outeut in the. following manner: Tc where 

ec is the sesaciated printable character if hex 46 was added 


to its Value. For examnele, ascii 83 will be cuteut as 1C, 
and 15 as TH. ete. 
In addition. some of these contral cades have srecial functions 
im MAE. 
Cenmtrol codes which have seecial functions are: 
CODE DESCRIPTION 

aC] Hutt Chess EA 

TE ‘estore zero pare and 20 ta Fasic 

oh Restore Tero race and wo ta Monitor 

TG + Be 11 

TH + BFacksrace (delete previous ly entered char.) 

tI + Horizontal tak to next S-th char. position 

TI ¥ Linge feed 

tt + Carriase peturr 

m1 Cormtinue ereacessine but no auteut ¢same as DEL? 

Ti! + Continue after stor via break key 

TH Telete entrire line altered 

Tr festore zero pase and JjJume to location FHeGB, 

CYOuU Way reenter at FiG83% 
Te Terminate pracessinga and aa to "J" level 
TO + Escare character 
# = Honc-erinting control character. 
14. COMHECTION OF A SERIAL DEVICE 


A serial dewice mag be connected to your FET and cantrolled by 
MAE softwere. MAE senerates dats in TTY Car FS2322 data 
format an the USER wmort Chit F ein = auteout, 

nit 6 wim E = ineuto. The data format consists af one start, 
seven data, and two stare bits. Since these sisnals on the 
Weer wart are TTL levels. circuitry may be reauired ta 

Provide 2 rrocer electrical interface. We have found, though, 
that PS232 terminals such as the Syunertek KTM-86 can be 
conmected directls to the user port. If you do cerovide 
interface circuitrs, you should not invert the signals as they 
are in eositive true state. 


hare 


The commands JTI and J7T0 are erovided ta direct MAE to 
inrut or cuteut on this serial wort. 
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11. EXAMPLES 
A. TED Exame les 


#1 Illustrate toa ways to load MAE using MAECDOS sureort 
and besin execution at cold start. 
“MAE. EXE® ar: AL: 
SYS 2045 


#2 Illustrate two ways to load and initialize the extended 
monitor CExXTRAMOM?. 
EXNTRAMON. EXE cr hc 
SYS 496 


#3 Illustrate entry of text. 
JAUTQ $18 
71@86; THIS 15 A TEST 
1816L00P LDA VALUE. 
14246 = NOF 
L1O3SUEND.FPGhM JEN 
1646-7 Hate, enter -- to exit 
alto line #-irs 


#4 «Illustrate listing of text. 


JPRINT 

ieee ;THIS IS A TEST 

1616 LOOF LIA YALE. ' 
1u26 HOF 


1636 END. POM EH 
ve 


#5 Put file to disk (device 3. drive 8) with mame TEST. 
JFUT DS “a: TEST" 


#6 Get file fram disk tdewice S. drive 12 named TEST. 
JGET “@: TEST" 


Note: The default is device &. 


#7 Assemble file CRTIVWE and senerate = Llistins. 
JASSM "CRIDIVE" LIST 


#& Uuteut directory for drive &. 
Jc 83 "su" 


#9 Scratch file TEST. 
We "Ss: TEST" 


#16 Read disk error channel. 
JBC 


#11 Direct outreut to IEEE rwrinter ¢device #4). 
JTG IEEE 


#12 Direct cutrut to Serial device at 300 baud with 
16 pad bits. 


#13 


#1 
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JT SERIAL 1 18 


Assian serial device as inrut keyboard? and 
outrut cwith = rad bits). 
JTI TERMINAL 2 


s - user types S om serial keyboard then 
types RETURN. 


Find all occurrances af the text LDA. 
JFINE “LDA? 


Rer lace all occurances of LDA FA with LDR #FA 
between lines lub and 20H. 
JEDIT “LOA FA-LOIAR #FR- 1eBe 2eou 


Frovide for 15 caracters rer label. 
FORMAT SET 15 


Cuteut all fixed texternal? labels. 
JLAERELS FIXED 


Renunmeer the text file beasinnming at line number 168 
and increnentins by &. 
JHUMBER 106 5 


Move lines lee t 
IMNOVE Sen 1Aw Z 


fe the text file to $468 thru 1FFC 
#4n4 $1FFC 


JEASIC return wia SYS 26486 tcold start) 
or S'S 26483 “warm start 


Go to Machine Langusge Moniter. 
JEFERK. return visa G SHB Ccold start) 
or G SBS Cwarm start> 


Run assembly program at symbolic label BOX. 
JPUN BOX 


Chanse from Uppercase-Grachics character set ta 


Lowercace/Urrercase or vice versa. 
JALFHA 


ASSM Exame les 


HKeygin assembly at $1464 and store object code. 


-BA $1606 
OS 


#3 


#4 


#5 


#16 


#11 
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Besyin assembly at $1680 but store object code at £4006. 


-BR £1006 
Mc 80648 
OS 


Define the CRT output routine. 
CRT NE #FFD2 


Assign an internal work location in zero wase,. 
WORK JIT #6 


Rllocate 6 butes af storane. 
TABLE .IS 6 


Tlefine label EQI as mask with bit 6 set and shaw wee 
in ANI statement. 
Eal ~DE 61 eae 
AHI #0] 


Load the low address part of the label VALUES im resister # 
and hish part in resister ‘yr. 
LIK #L.VALUES 
LI’) «6 #H. VALUES 


Give exanrle of . BY eseudo ar, 
BY “ALARM CONDITION ce MOTOR 1° #60 ¢ 


Ca 
Tk 


Store the address of the internal label THELE and 
the external label FETOUT., 

~=Il TABLE 

SE FETOUT 


Define the contents af the text file as Macra Global 
£0 its macro definitions can be used by subsequent 
files in the assembly. 

MG 


NOTE: This locks the macro definitions in the text 
buffer. If sou set a !OF error on subsequent 
loads, wou should kroaw theck vou have aver lowed 
the text buffer. The solution is to allocate 
more memars (vis JSET commend? and then 
ressscemk le. 


Show examele of a Yersw lon label. 
MEMORY. TEST. FOR. 6562 
JHE MEMORS'. TEST. FOR. 6582 


NOTE: Longs labels (greater than that srecified via 
JFCQ command> are allowed if defined om a 
line with mo mnemonics. 


Reference the call to the PET RDT ascii character routine 
so the relocating loader will not alter the address 
during loading. 

RDT DE $FFCF 
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-~- OR -- 
JSR $FFCF 


12. GETTING STARTED WITH MARE 


An extended monitor eroaswram CEXTRAMON)? is contained on the 
sure lied diskette. This program, develoared by Bill Sei ler 

af CBM. provides many additional monitor commands which will 
he of tremendous hele in your program deve lompment at the 
object cade Level. Therefore, we recommend that you load 
ESTRAMOW with MAE. If vou are urfami lar with EXTRAMOH, 

load the Basic erogwream EXTRAMOH. IMS for an interactive review 
af 1ts mans ecwerful commands. 


Load MAE/DOS, MAE. and EXTRANOW ae follows 


1->)«6Insert surplied diskette in disk drive @ 

Z-> Load MAE DOS sunecort program via LOAD "#",8 

3-2 «6Type RUM to initialize DOS suerport program. 
Note that the screen eroavides a descrirtion of 6 additional 
TS commands: AC. AW, MO. MA. LO, LA. 
These commands are aids to auickly load and transfer 
control ta ather MAE proswrams. 

4-5 Type MC to lead and initialize the extended monitor. 

raat Type 68 to return toa BASIC. 


6-3 Ture AC to load and cold start the MAE Assembler/’Text Editor. 
MAE will reseoand with: 
C 1979 BY C MOSER 


WAP Fe is6u-2FFC 80 p*# Sh 


This displays the default allocations of memory for the text 

file (SBH6-4FFC>, label file C1S3HH-2FFC>., and start address 

of the 256 byte relocatable buffer (7886). On the next line. the 
current end of the text file and label file are disr layed. 

Since they are initially cleared. these are the same as their 
respective start addresses. ‘You should note that the current 

end will change as you insert’delete data in the text file™ 
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and label file. The JSET command can be used ta disr lay 
this range again or alter the file boundaries. 


Remember, to exit MAE. issue either the JBASIC or JBRERK 
commands ta so to Basic or ta Monitor. Sou may reenter MAE 
Wie $5405 Cwarm start - eversthina preserved? or #5800 
Ccold stent - everuthine cleared ta default states. 

If wou are in BASIC. tare AW to warm start MAE. This is the = 
as .G S@83 and SYS Sh4a3, 


ty 
th 
ro 
= 
tT 


Also. you should note that EXTRAMOWN oocueies memares 

at $1600-$17FF and MAE sceumies F5660-F77FF. EXTRAMOM also 
sets the Basic variakle HIMEM to $1000 to indicate the end 
cof memors avai lable for Basics use. This in effect protects 
EXTRANOH, MAE. and other erowrame shove $1008 fram beiris 


"elobbered" bu Basic. ‘tou will want to marualla reset 
HIMEM if Basic issues an cut of memorsa error. HIMNEM mers 
be reset ta its cold start value as follome: 

ADRESS IATA 

£6034 cA 6) 5) 

$hHs5 Bd 


The #iret thins you showld da naw is to load the MAE.LHOT file wis 
JGET "MAE. MOT" 
JFORMAT CLEAR € turn Fformattines aft 
JAL + enter urcere lower case mode 


The MAE.NOT file will contain ane rertinent information rertainins 
ta MAE that was discavered after this manus) was printed. 
Please review the information im this file. 


Now vou should start elasging arround with MAE kes escecutins 
its commands and then eraceedina to enterirs pricesrame. 

Try reviewina the commands in eart 4. assemk ler features in 
rart 5, and then the exameles in eart 18. 


We hape sou find MAE to be an exce lent mr 


l mars chee Lovemerrt 
aid and & worthwhile inuestment. Havers Assen 


ike Larva! tl 


vt 
7 
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13. WARE Simplified Text Processor (STP) 


The MAE Simp litied Text Fracessor (STP) is a word rrocessor 
erowren desiauned srecifically ta work with the MAE text 
editor. The erimare eurrcose af this word processor was 

te erowide = simelitied means to erocess rrogram documentation 


and for other text processina meeds. This simelicity was 
acoonme lished with a set of 16 essily remembered word crocessins 


functions. and usgave af an already familiar text editor to 
enter and edit the ram test. 


STF. unlike the CEM Meard Pro prose sms. cert outeut the formatted 
text ta the sereen. This is most useful om 86 column disre lags 
and can result ino a tremendous fsavirnss in time and rarer. 


To instruct the word processor to rerform 2 word processing 
functions ane inserts text macros im the test ta ke formatted. 
A text macro aluass kesims with & eeriad ¢.39. always begins 
im column 1d. mad be entered as urrer or lower case, and may 
cr mee mot have associated parameters. The fallowins are the 
Heo provided key the STF word eracessor : 
MERTICAL SPACING “.vseace rio 

This macro is used to erovide sinsle. double. tric le 


Saracina, etc. for the entire auteut. Enter the macra as shawn 
above with the desired seacina. For examnele., to resuest a daub le 
sraced cuteut. enter .verace 2. 


TEMPORARY IMDEMT «.sri 


m= the number of seaces ta indent. For examele, .s3 will indent 


Toa indent m spaces on the next line, use the .=n macra where 
races 
the next line 5 sraces from the right. 


NARGIW CONTROL «om ee Oe 


The marsins default to 66 lines rer paste, left margin begins at 
column &. erint width = ré characters per line, and the number 
of blank lines between text kody and each title and footer = 3. 


The parameters in the margin macro are: 
n= left margin besin position ‘tdefasult = > 
P= number of characters rer line ¢default = 76> 


A number of lines per page minus r. Exanele if lines rer 
pane = 66 and the number of blank lines between 
titles and footers = 3. then «a = 66-3 = 63. 

r = number of blank lines ketween text badu and each header 


and focter. Default = 3. 


For examele ta specify left margin to besih in column 5. reprint 
width of 64. 66 lines’rase, and 4 spaces between text body 
and titles and footers, enter .m5 66 62 4. - 
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If you enter just .m 5 66, the rrevicusely entered values for 
rarameters a and r will be assumed. The margin may ke changed 
at any point as desired in the text. The maximum value for n 
is (*é. 


TURN OFF JUSTIFICATION “.nofillo 


The .nofill macro turns off the justification function. 
This means that the lines will be erinted without adding sraces 
to make the margins came cut even. Also. wards are moat combined 
to Fill to the specified marsins. 


BEGIN A NEW FAGE ¢.ff2 


The .¢# macro may be entered when ane wants the erirrter to 
eject ta the tar af the mext page. 


LITERAL SPACE ¢tT character) 

Normalla.s = are not processed like ather characters. 
If several seaces are entered consecutive la. the STF werd 
Processor recanizes only one srmace. and deletes the rest. 
If it is desired to force 2 certain runmber af seaces in line 
for tabular formats. etc... a strings of caret Cfo characters mag 
be inserted into the text. The caret will mot be printed when 
the text is processed but instead a sreace will be erinted for 
each occurance of the caret. 


ee 


a 


es 


fa! 


TURN ON JUSTIFICATION ¢.aupd 

The .Ju macro mas be entered in order ta restore gustification, 
Ju is normally used to revert back ta guetification after 
usina the .nofill macrea. 
RAGGED FIGHT MARGIN ¢.rra 

This macra turns off the addition of spaces in order to make 
the marains come aut even. Wards are still combined in carder 
to arpraximate the srecified number of characters eer line. 
The lett marsin will be straight but the risht marsin will be 
ragvded, 
FAGGED LEFT MARGIN ¢.rl? 

This macro is the same as the .rr macro excert that the 
right margin is straight and the left marswin is rasved. 


SKIP NEXT N LINES ¢. Ind 


Use this macro to skip a number of lines before printings the 
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next line of text. For exanrle, ta skir 2 lines and hegin 
erintinea, enter .12. %I4 you enter .1 by itself, one will be 


assumed. Thus .1 and .li sre eauivalent and each will result 
in & movement to the next line. 


CENTER LINE OF TEXT ¢.c texto 
This macre is useful for centerins a line of text. For: 
example, to center the phrase STP Word Frocessor, enter 
.c STP Ward Pracessor. 
SHAF JUSTIFICATION MOTES ¢. swap) 
. This macre is used ta switch from .rr mode to .rl and 


VLC WeEProa. 


RAGRAPH SPECIFICATION ¢.6 do ro and PARAGRAPH IDENTIFICATION ¢.r 


FA 

ce the ce dor meero to inform the word processor what a 
rap asrarkh 1 supposed to be: d= number of lines down, and 
ro o= rumber af sraces rizht for earagrach indent. The default 
isd =i, andr = 8, 

In arder tea identifea a rarayrach stort in your text, 
use the of macro with mo earame ters. 


FAGE TITLE ¢.t# title text> 


Hone line title at the tar of each rage mas be entered using 
this macra., Far examele. ta srecify the title CONFIDENTIAL: enter 
ot COWFITEHTIAL. If you want te alsa include a paxye number. 
enter .+t# COMFITDEMHTIAL. Hote that the # srecifies page numbering, 
If you want just a pase number ¢the default stated. enter 
Just .t#. If sou want neither title nor rase number: 
enter gust .t te turn of # all titlins. 


PAGE FOOTERS «<.foot# foot texts 


Aone line footer at the bottan of each rage may be specified 
l= itis thie macro. The rarameters for .foot are the same as 
for the .title. The default is ma footers. 


CREATING SHAPE TABLES ¢.shape m and .set nm 1 wm 


The STP Word Pracessar has pravisians for printina text in 
Werilous shane formats by using = table ta control the right 
and left marains. The wshare macra is used ta define the share 
to be used. Share 1 is in the form af an “I*% and entered by 


Slime la enterins the command .sharpe 1 at the besinnins of the 
text file. ° 
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create 3 user defined 
Share, ,set macros are 
table corresrondings to 
in the .setn le are 


So macre mast be used ta 
to define the desired 
entries in the user share 
The parameters 


The . share 
share. In order 
used to make 
the desired share. 
foal lows: 


a>. 
m= line rumker for this marsin srecification 
Ll = column for left marsin start 


Ps number af characters to be printed an this line 


t+ 


a 
& 


For exam le. defir 


et 14 5 46 e> line 14 as left marain starte 
im colunm 3. and there are 4a characters to be printed an this 


line. 


Hormallbsa ane would have to enter 66 set macros toa come lete 
the user shave table. But it should be noted that et @ le 
l= a Sseecial case. The @ Cwhich would normally reeresent the 
line number? indicates that all lines in the file are set ta 
left marsin of lo and print width of ew. This is useful SCHL 
can set all lines in the user share table toa a rarticular 
marsin and then use non 8 values to chanse certain lines tea 
form the desired share. 


= 
ESE 


a 


4 
az 


Hote: Alwaess enter the share | macro before the .set macros 
The reszon if that ss saan at the .share 2 macro is 
encountered, it fills the user share table to default 
wWelues of left marsin = 8. and eprint width = 48, Thue 
if sou enter .set macros first, thea will be 
overucitten ba the wsharee 2 defaults of & and 48. 

If .share 2 is entered and neo share commands are ertered, 


This is veryw useful when 
cuteut on PETS which 


the marsins will default ta .m @ 48, 
it is desired to wien the formatted 
have 49 column screens, 


DEFAULT CONDITIONS 


The follomins are a mumber af assumed defaults that exist an 
initial entry to the word erocessor. 
Justification = oan 
Sharins = at¢ 
Marsvins = 66 line srave, 3S blank lines hetween text beady and 
titles and footers, left marsin = @ and rerint 
width = 7s. 


Vertical Spacing 


Parasrarh = 1 lin 
Pase Title = pase 
Pase Footer = no 


HOW TO USE THE STF WOR 


1% Load the word pr 


= 1 ¢sinsle spaced cautrut: 
©® down and 5 space indent 
numker but no text 
text or pase number 


Ir FROCESSOR 


racessar and MAE via: 
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“HORDE. EXE 
AC 
Hate: Basics Hi Mem pointer ($34, $35> is set above the 
word pracessor. Either rake this pointer to $6706 
ar refrain from using Basic commands which use 
Prosran meneard space, 


2906 Enter upper case’ lower case mode via the JAL command. 
Clear format made via JFORMAT CLEAR. 


3) Enter raw text using MAE for editinsa. Include all 
necessary text rracessins macros. 


40 When wou are finished entering the raw text and 
associated text macros. senerate a formatted cuteut via: 


JEU $7 ee & for auteut to CET only 

IRFU Fas | for cuteut to CRT and Printer 
EXAMPLE 
A oratn test £112 mamned HORTF.LIHS is contained on the diskette. 
Tare JGOET "HORTPLEXE" ta load this file. Tyee JPRINT to 
examine the reu text with associated macros. 
Tore JRUM $P°ee CCRT anly? or JRUN #783 CCRT and Printer> ta 
execute the word eracessor and cuteut the text in word rrocessor 


format. Hebe: TF seu cuteut this ta a 46 eolumn PET, it will 
mot apeear meek since the marsin was set for 76 characters 
meer Lire, 


How nonce the pau test printout with its text macros to the 
formatted auteuat szenerated ku the word processor. Examine 


these tuo erinrctouts until you are familiar with the 


function of the STP macros. 


14. SPECIAL NOTES 


* Wher enterins source modules Cwithout .EN®. you can perform 
& short test on the module by assemblins the module whi le 
in the text file and watchina for the !@7/ error. I¢ 
other error messaves occur. you have errors in the 
module. This short test is not a come lete test but does 
check to insure you have lined ur the #ields prorer ly, 
not entered durlicate lsbels within the module. or 
entered illegal mnemonics ar addressing modes. 


* An 86 character’ line cauteut device should be used when 
Printing an assembly listings in order to provide a neat 
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printout without #foldover ta the next line. 


* Immediately after using the PET Machine Languase Monitor 
to save a program. always * ta Basic and then siS 1024 
back to the monitor. The resson is that the IRD vectors 
are destroyed ky the PET save software. 


* If you are soins to use MAE and Basic tasvether, alter 
HIMEM <$6834, $88352 so Basic will not clobher MAE, 
ar its text or lakel files. 


# Use auslityu diskettes like SCOTCH or DYSAN. A fey 
dollars saved an a chean diskette r= not worth the 
risk of lost data. 


* Due tea some "stranse”" disk erablems, mever use the save 
with rep Lacement feature (igo - Examele: IJPUT “@1: TEST. Mei" 
ar even SAVE "@:FILE".&, 


* We recommend that & namins comventian for ocr fi les 
be established. We use the following extensions 
rane. CTL - Control Fi le 
rene. fx - Module referenced in Control Fi le 
name. ASM - Source Fille without CT 
rane. EXE - Executable ckject #1 le 
name. REL - Relocatable abject #1 le 
name. MAC - File containina all Macros 
name. LIE - Liktrares of sunken ls 
name. MLIE - Likrary of Macros 
rede. DOC - Froarem Documentation 


User instructions 
name. NOT Prowran Notes 
name, BAS Basile Proosreun 
name. DAT - Basic Data File 


name. IHS 


is. ASSMTED USERS GROUP 


An ASSH’TED Users Grour has been formed bs James Strasma for the 
exchange af eragrans and uniaue modules. Most of the information in 
this exchanse is MAE compatiable. The cast rer diskette is alsa 
fwinimal but the information is extremely useful. 


Some af the more notable programs on the first diskette are: 


UNASSEMBLER."MAE - Basic program which disassembles into a disk 
file compatible with MAE. 

KEYSORT - M.L. program for sortins Basic variables 

MAE/DOS. ASM - Source for the MAE“DOS Suprart rerogram 

EPROM PROGMF - 27162732 EPROM programmer which connects to 
User Fort. 

PETI6G - Sweet 16 interpreter adarted for the PET 


For more details, contact: 
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James Strasma 

cco Grace U.M.C. 

126 West Kins Street 
Decatur. Ill. 62521 


16. EXAMPLE LISTING 


An example of a program in MAE“s syntax follows. This rrogram 
is the URFT driver comtained an the suprlied diskette under files: 
WART. CTL. URFET. M61, URRT. Mae. UART. Me3. 


The URET driver erogwranm has three entry roints: 


i> SET. BAUD - Oetional entre used to automatically measure user 
terminal baud rate. 

2) URRT.OUT - Quteut character in RCA>. 

3) URRT.IW —- Irneut character and return in RCAD. 


The UART erosrecm is free tao use bu MAE rurchasers for any 

MoM ooOMMerical eureoese., For commerical use. we only reauest 
that sou briefly write describins the use of the UART rrogram. 
We renuest mo monetary essment or ara other renumeratioan. 
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CT sDESIGHATE AS COHTROL FILE 
CE SCOHTIHUE IF ERRORS 
BA #2600 
++++4+++ TEFIHITIOWS ++++++4++ 
FIA. PORT ~DE #€e41 sFIA DATA PORT 
FIA. DIF ~DE #Ee43 /PIR DIRECTION Fort 
Mak. IM ~DE BAL eee STIHMFUT [5 OH BIT 6 
MSE. QUIT 2UE 21 8neeoHe sOQUTPUT IS OH BIT 7? 


HO.PADEITS .0S 1 iHO. OF PAD BITS OW CR LE 
EIT.TIME .DS 1 VERUD RATE CODE <a-73 
iA = 146 4 = 2400 
i= 300 S = 4300 
if = 6GG B= 72u0 
i= 1200 7 = S600 
JFL DS "UART.M@1" 3SET BALI AHI TABLE DELAYS 


SET 


LF 


Lr 


LPS 


=a 
—— 
7, 
im 
— 


++4+4++ SET BAUD FATE ++4+++ 

» BRUIT FHF SSAVE FSk 
SEI sCLERFE IHTERRUFTS 
LIA FIA.DIF i INITIALICE PORT ON LOGOH 
ANT #$FF-MSE. IW ; + 
ORA #hMSk. QUT : + 
STA FIA.DIF ; ¥ 
JSF GET. BIT 
EWE LPi ;BR. IF ALREADY SPACING 
LIA FIA.PORT 
AND #hNSk. IN 
FEV LP2 jBR. IF WARKING 
LOY #64 iCLERR FOR DELAY FACTOR 
LIA FIA.FORT sGET BIT 
AND #hMSk. IN ; * 
BE GOT. COUNT 
CPY #$FF 


BEW LPS 


FAGE 4¢ 
IN’ 


sae7- C8 A220 
Sazes- [Tl Fe B23 SKF.FF BHE LFS 
hod 
SAZA- 9S A258 GOT.COUNT TIA iMOYE COUNT TO RAD 
S2B- AB AG Boon LIY #00 
Seet- 06 SF 26 Berea LP.FI CHP TBLEAUD, Y 
SAsh- Be a 5 te BCS GOTBAUD 
eS ee Bes IH 
Sasa [Wa Fa ASA BHE LP.FI 
SHS5- 80 81 2h 351i GOTBRUT STY BIT. TIME STORE BAUD RATE CODE 
SASE- AZ BC ASS LIX #12 sHAIT UNTIL ALL BITS HAVE 
SASA- 2a BE 2a aoe JSF FAD. DEL 
SH30- 25 34 PLE 
SASE- 66 S56 RTS 
ASE 
S| 
SASF- FF A328 TBLEAULD BY 255 i = 116 
SAda- oo Aso -BY 147 ) >= Sheu 
=Adi- 4A mda BY ¥ » 2= 6HH 
Baqdz— 2S Adie ~BY 37 » 2= loeb 
Saga- 12 Sr eds Br 18 i >= 2406 
o44—- A A430 BY 16 + 2= 4866 
sa45- ay Adda ERY i 3= 726 
Z[ed6—- GA A458 BY & s 2= 3600 
B46 
B47 Es 
Se47- AD 41 6S 8458 GET. BIT LIA FIA.PORT ;GET KEYBORRD IHMPLT 
SAd4A- 29 da A430 AHO #hsk. IH ; # 
SA4C- 66 ASee RTS 
Ho1e 
SA40- AD #1 26 8528 DELA.S LDA BIT. TIME 
SASH- 12 BSSe CLe 
Sasi- pe Hoda CLO 
2HMa2- 63 BS bathe] AIC #88 
SA54- AS AS8e TAY 
SRSS- 40 55 so ore JMF ENa. 5 
es beet | 
SAS3- AC BL fe 8598 DLY'FULL LI’ BIT.TIME 
SHIR- BS 66 2H Behe EMAL LOA UD. TBL1.' 
SWIE- Fae 16 Heda BEG! MOT. THIS 
HE AG Bea TH" 
2ae1—- 86 Bese LOOPTELL DE’ 
SHe2- Iie FI Bede BHE LOOPIIEL1 
ZHE4- EA HES HOP 
ZHES- 60 He6e RTS 
Here 
Heew ;---DTELATH=SK+159 
SHEE- Be Hes UD. TELA BY Be sTELAY FULL FOR 116 BRUD 
ZHey- wa 7a .BY 86 /DELAY FULL FOR See ¥ 
SA6S- AG A716 BY oH SDELAY FULL FOR 660 # 
2463- 3A AVZu ~BY 154 :DELAY FULL FOR izeu # 
Z2HeA- 47 i738 ~BY 71 is DELAY FULL FOR 2486 & 
eH6B- 1D H744 -BY 29 JTELAY FULL FOR 4560 %# 
2HeC— OF B/7S8 -BY 15 i DELAY FULL FOR 72ee & 
ZH6I- a6 A7éG BY ag iDELAY FULL FOR 9600 # 
W77e 
H’S&6 ;---DELAY=Sx%+29 
e46E- 86 H7 50 ~BY ae sDELAY 4.5 FOR 11@ BRUD 
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s-- DELAY S4 tee 


WO. TLS 


as 
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BY 167 


~BY Bb 
LEY 3n 
JBY 88 G8 84 Be Be 


BY 14 
"FI DS "WART.Mae" GU 


; +++4++ WART GUTPUT +++4++ 


UART. OUT 


WART. OUT 


LF. UOUT 


FHF 
SEI 
JSR UART. CITI 
F'LF 
RTS 


FHA iSAVE C 
EQR #3FF 

FHA 

LI #11 

SEC 

JSR BIT.QUT 

JSF DLYFULL 

PLA 

Lk A 

FHA 

DEX 

BHE LF.UOUT 

FLA » REMOVE 


»DELAY 4.5 FOR 366 # 
>DELAY 4.5 FOR 600 # 
sDELAY 4.5 FOR 1200 & 
iDELAY 4.5 FOR 2400 & 
/DELAY 0.5 FOR 4500 %# 
»DELAY @.5 FOF 72au # 
/DELAY @.5 FOR 3606 ¢ 


#45 $45 #485 
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sDELAY FULL FOR 1i E 
iDELAY FULL FOR sae 
sDELAY FULL FOR ee 
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SDELAY 8.2 FoR iif EA 
JDELAY 8.5 FOR sae ¢ 
iDELAY B15 FOR eb + 

ART OUTPUT DRIVER 


iRESTORE PSR AMT RETURN 


HAF: . 
» THVERT 


:11 BITS: 1 STOP. & DATA. 


iBIT TO FORT 

: DELAY FULL BIT TIME 
iRESTORE Rene 

:NEST BIT 

SAND SAVE 


» LOOP 
JUNK 


PAGE 58 


ZHBS- 6S B23 FLA sRESTORE CHAR. 
SHES- 29 FF B24 AWD #$7F »CLEAR BIT 7 
SORS- C3 al ASo8 CMP ##a1 i CR 
SABP- Fe GE Be68 BEG FAL. DEL 
SHBS- C3 BA SS CMF #204 iLF 
SHEB- Fa ay tad BEG PAD. DEL 
SAED- 58 se ETS 
SiMe S15) 
SORE- 45 B18 FAD. DELS FHA 
“GEF- ER ae ASI CPs #58 
SAli- 40 08 26 Base JNF FAD. DELEN 
B34 
BACd—- 4 she] PAD. DEL F'HA s PRESERVE 
saeeT HE BH Se Bee LI NO.PADBITS sGET # GF PAD BITS 
SACS- Fa Be Bore FAD. DELEN BE Ex. DEL sSKIP IF ZERO 
aca SA 58 26 wade LP. PIEL JSF DLYFULL > DELAY 
SACI- CA ASH DE 
SACE- [ia FF SDS) BHWE LF.PIEL » LOOP 
DAT 6s A418 EX. DEL FLA / RESTORE 
ZAT1- 66 B4o8 RTS 
Bese 
SeD2- AD 41 ES 44a EIT. OUT LIA FIA. FORT sPUT BIT 
SBRa- 23 7 B458 AMT #$FF-MSE. OUT 
SaDP- 3H AS A468 BOO SEP. BOUT 
eB0s- BS 3n Hd re QRA #M4Sk. OUT 
SeDE- 20 4] 6S 4a8 SEP. BOUT STA FIA. PORT 
[aTE- 8a m4 56 RTS 
Sibel) 
ASL 
ASS ~FI DS “URET.N@3" SWART INPUT DRIVER 
Bega ZaSE-25e6 WART. Mes 
Slop aS 
AMS 5 +++++ UART INPUT +++++ 
5) Me 
SQDIF- oe Bede UART.IN FHF’ 
SAMEW- FS bat] SEI 
SMEL- AS Be HSE LUA #198 »CLERF CHAR. 
SHES- 45 SSeS FHA # 
SHE4- 26 47 2H Bese LPLUT1 JSF GET. BIT sGET BIT 
=BEr— DW FE shee) BWE LF.UI1 :LOOP UNTIL NO BIT 
1a 
SHES- 2H 47 26 8116 LFUI2 JSF GET. BIT GET BIT 
HWEC- Fi FR BLz6 BE LEU sLOOF UNTIL START BIT 
A136 
SWEE- 2H 40 26 wide JSF DELG.S :TELAY UNTIL MIDDLE OF STA 
SAFi- 24 47 26 4156 LFLUIZ JSF GET. BIT iGET BIT 
SMF 4- Fe BLEW SEC ASSUME SPACE 
eHFi- [i @i H1 7k BHE SKF.UT1 
ZHFF- 15 mice CLO :NQ IT IS MARK 
2FS- 66 His SKPLUITI PLA 
eHFS— 6A H2h4 ROR A sROTATE RIGHT INTO CARRY 
ZeOFA- Bo ur 0216 BCS DNONE.WUI 
2M4FC— 46 M226 FHA 
24FU- 26 58 26 236 JSR DLYFULL jDELAY UNTIL MIDDLE OF NEX 
216u- 14 H246 CLC 


- 
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21G61- 9@ EE 256 BCC LF.UIS 
21@3- 49 FF @268 TOWE.UI E0R #$FF 
2105- 29 7 B2eru ANI! ##7F 
Z21Q7- 28 8288 PLF 
21G8- 68 H298 RTS 

8338 

B340 

W350 

W360 EMD. PGM ~EM 
Pr OPE PHS S | 
--- LAEREL FILE: --- 
BIT.QUT =2uIe BIT. TIME =2hH1 
DLYFULL =205e IOWE UT =21e2 
END.PGM =2169 ExX.DEL =2ulin 
GOT. COUNT =282H GOTBAUD =2e35 
LOOCFIELS =28H7A LF,FI =2620 
LP.UI1 =2GE4 LF.UIS =2HES 
LP. UCUT =28AS LPi =268E 
LFPa =eaic MSK. IH =pe46 
NO.FADRBITS =2Hoe MOT. THIS =267r6 
FAD. DELEN =28Cs FAD. DELS =2HBRE 
FIA.LFORT =ES41 SET. BAILII =2hh2 
SKPLFF =s8es SEF.UI1 =20F8 
URRT.IN =280F URRT. OUT =2H37 
WD. TELi =2666 WOLTBLS =2650 

‘RAGE. S165. 2105 


; 


»sLOOP FOR HEXT BIT 
sTHVERT 

sCLERF BIT 7 

*RESTORE FSR AWD RETURH 


TEL. 5 =2a4D 
EHMHa.5 =205B 
GET. BIT =2647 
LOMPIELL =2061 
LF.PIEL =24CH 
LPJUITS =20F 1 
LFP2 =2613 

NSE. OUT =H 
FAD. DEL =sHr4 
FIA. DIF =ES43 
SKF. BOUT =2808 
TELEAUD =2sF 
WAR T. OUTIL =2e36 


Posi — IseFIPC 
he rp ? 
Vovons PCE - 36n Cigg*~ a | 


VOV (64s FS Fp 


Lops FCC 

fo Fr gc 
GO0O—- S554¢ 
SGAS — >F39 
CFAC ~ 6 UTE 
6190 - 6646 
6665 — Lyte 
Gonr - bECE 
GF — 726° 
Fr 64 —ALDL 
7rEg - NFO 


230A - I50A 





PRINTING CO. 


620 S. Peace Haven Road 
Winston-Salem, N. C. 27103 


WE WILL ASSIST WITH SPECIAL DESIGNS 
(919) 765-2665 JOHNNY & HAZEL WEISNER 


——— ERROR CODES ——— 


ERROR CODE DESCRIPTION 
1B -EN in non .CT file when .CT file exists. 
1A EN missing im .CT desizynated file. 
13 Found .FI in non .CT file. 
18 
17 Checksum error on disk load. 
16 
15 Syntax error in JED command. 
14 Device mumbers @.1,2,3 not allowed. 
is Multiele .CT assignment. 
le Command syntax error or out of range error. 
11 Missing parameter in JNU command. 
18 Qverflow in line # renumbering. 


CRUTIOWN: ‘You should prorer ly renumber the 
the text file for erarper command oreration. 


AF QverFlow in text file - line not inserted. 
HE Qverflow in label file -— label not inserted. 
mI MAE expected hex characters, found none. 

He Tllexzal character in label. 

HE Urine lemented addressing mode. 

WA Error in oar mo operand. 

he Found illewal character in decimal string. 
Ws Undefined label may be illegal label). 

wy ~EH eseuda arm missin. 

He Inu licate label. 

Sha Lake l missing im . DE or . DI pseudo or. 

4 ~BH or NC operand undefined. 

WS ITllexyal pseudo cr, 

We Tllesa1 mnemonic or undefined macro. 

1 Eranch cut of ranse. 

TS Net & zero pase address. 

Et Error in caommancd input. 

ZF Cver¢law in file seauence count C2##16 max. > 
ZE werk lou in sumber of macros C2#¥16 max. > 
ZI 

2: 

2 ME without associated .MU 

ZA Hon-ssmbo lic label in SET pseudo ar. 

29 Tllesal nested definition. 

ed 

27 Macrae definition overlarns file boundary. 

26 Tuc licate macra definition. 

25 Guantity parms mismatch or illegal characters. 


Too many nested macros ¢32 max.) 

Macra definition not camelete at .EN 
Conditional surrpress set at .EN 

Macro in expand state at .EN 
Attempted expansion kefare definition. 


Mra foe to 
Me had pb 


